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When a game cartridge is entered and the door closed, control is given directly to 
the game.' The following describes the .two methods of selecting a game: 

MENU 

- The game displays a menu of games. 

- User enters corresponding number on keyboard. 

- Game starts immediately. 

- Game start key restarts currently selected game. 

- Game select key causes the menu to be redisplayed. 
Option select; no action. 

- System reset: enters warm start of cartridge. 

- Control 1 may make game pause. 

NO MENU 

a. 

First game displayed; £qxn line displays the following: "GAME 1, OPTION l. n 

- Game select button causes next game to be entered and the game number in the 
top line to increase. If button held down, the game increments every .5 sec- 
ond. If depressed while executing game, it exits game and option numbers are 
set to Xm 

- Option select: same as game select but option increases. If executing game, 
it exits game, leaves game number select as is, and resets option to i. 

- Game restart: starts game initially and restarts game, if currently active. 

- System reset: enters warm start of cartridge. 

- Control 1 may make game pause. 

1-U Player Game : Assign controllers from left to right. 

Copyright will be displayed at the beginning of each application: "(C) COPYRIGHT 
ATARI, (YR)." 



Attract is done automatically by the operating system. 

All cartridges should use OS initialization which requires storing cold start 
address and executing a RTS. If cold start and warm start addresses differ, 
the warm start address should be stored when control received for cold start. 
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y * FILENAME = CARTP. INF " 

#*#»♦*****#******♦**********************'* ******************************** 

CARTRIDGE/OPERATING- SYSTEM INTERFACE REQUIREMENTS 

2/21/79 



THE TOP 4 3YTES -OF-ADDR- SPACE OF A CARTRIDGE ARE USED BY THE 

COLLEEN OPERATING SYSTEM (O. S. ). TOP ADDR FOR CARTRIDGE 
"A" IS "*BFFF", CARTRIDGE "B" IS "$9FFF'\ 



- mm 



BYTE O — TOP ADDR— 3 

BYTE 1 — TOP ADDR— 2 

BYTE 2- — • TOP ADDR— 1 

BYTE 3 — TOP ADDR 



THE FUNCTIONS OF THESE BYTES ARE: 

BYTE O — SET TO "00". USED BY O. S. TO DETECT PRESENCE OF 

A CARTRIDGE. 

BYTE -1- — FLAG BYTE. SEE TABLE BELOW FOR FLAG MEANING; 
BYTE 2 — LO BYTE OF INIT SUBROUTINE ADDR IN CARTRIDGE 
BYTE 3 — HI BYTE OF INIT. ADDR. 



• • • . « 



THE 0. S. WILL "JSR" TO THE INIT. ROUTINE. THIS ROUTINE MUST: 

X, INITIALIZE THE CARTRIDGE SOFTWARE. 

2. SET THE CARTRIDGE START ADDR <IF IT IS TO BE RUN) 
IN-THE RAM VECTOR- -"CARTST-" <02EO) . 

A HANDLER, FOR INSTANCE, WOULD NOT HAVE TO DO 
STEP 2. 

* • 

THE O. S. WILL THEN EXAMINE THE FLAG BYTE OF CARTRIDGE "A" & TAKE THE 

APPROPRIATE ACTION, AS PER THE BELOW TABLE. IF CARTRIDGE "A" 
IS NOT PLUGGED- IN,- THE CARTRIDGE "B" FLAG BYTE WILL BE 
EXAMINED INSTEAD. 
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CARTRIDGE FLAG ACTION DEFINITIONS 
BIT ACTIGN-IF-SET - - - 



6-3 NONE 

2 RUN CARTRIDGE 

1- - - RUN -BOS- 

0 BOOT DOS 



***** 

NOTES 
***** 

1. - IF -B IT- 1 --tt-B IT- -2 ARE O,- GO TO BLACKBOARD MODE. 

2. IF BIT C SET, THE DISK WILL BE BOOTED BEFORE ANY 
OTHER ACTION 
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F 


O.S. J 




E 


o.s. 


V D800 — FFFF 


MATH 




D 


2 K 10 


D000 — D7FF 


C 


NOT USED 


COOO — CFFF 


B 


SLOT A 


r 


A 


9 


SLOT B 

• 


8000 — 9FFF 


8 


linbug Ron 




7 


LNBUG ROM 


0 — 7FFF 


6 






5 




> 


k 


24K 




3 


RAM 




2 






1 




• 


0 




i 




CTIA 


D000--D0IF 




ANTIC 


dUoo— dUif 




POKEY 


D200 — D2IF 




PZA 


D300--D3IF 




DS 


ACIAS-D700 




LNBUG 


6000--7FFF 




LNBUG RAM 


8000--8IFF 




F000 — FFFF ltK 
E000 — EFFF UK 
D800 — DFFF 2K 




BOOQ — BFFF fcK, B800 — 3FFF 2K 
A000— AFFF UK 



NO CHANGE 
NO CHANGE 
OLD D800 
OLD DCOO 
NO CHANGE 
NO CHANGE 
NO CHANGE 
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COLLEEN /CANDY VECTORS 



eUoo 




OPEN 


2 




CLOSE 


1» 




GET 


6 




PUT 


8 




STATUS 


A 




SPECIAL 


C 


JMP 


POWER ON 


EUlO 




OPEN 


2 




CLOSE 


k 




GET 


6 




PUT 


8 




STATUS 


A 




SPECIAL 


C 


JM? 


POWER ON 



EDITOR 



SCREEN 



EU20 
2 

6 
8 



OPEN 
CLOSE 
GET 
PUT 

STATUS 



KEYBOARD 



A 
C 



JMP 



SPECIAL 



POWER ON 



W§2 
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EU30 
2 
k 

6 
8 



OPEN 

CLOSE 

GET 

PUT 

STATUS 

SPECIAL 



PRINTER 



c 


JMP' 


POWER ON 


EUUO 




• 

• 

OPEN 


2 




CLOSE 


k 




GST 


6 




PUT 


8 




STATUS 


A 




SPECIAL 


C 


JMP 


POWER ON 


• 

EU50 


JMP 


DISK INIT 


3 


JMP 


DISK INTERFACE 


• 

6 


JMP 


CIO 


9 


JMP 


SIO 


C 


JMP 


SETVBL 


F 


JMP 


SYSVBL' 


62 


JMP 


XITVBL 


65 


JMP 


SIO INT 


68 


JMP 


SENDEN 



CASSETTE 
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COLLEEN /CANDY VECTORS (concluded) 

eU6b intint 
6e cioint . . 

EU71 BLACKBOARD 

Ehfk WARM START 

EU77 COLD START 

EU7A PLA, PLA, RTS 



POWER ON and EUpO - SUTF consist of jump to routine. 



OPEN, CLOSE, GET, PUT, STATUS, and SPECIAL consist of address of 
routine minus one (jump instruction not included). 



